home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / umich / utils / volutil2.lzh / VOL_UTIL.DOC next >
Text File  |  1993-12-06  |  13KB  |  241 lines
  1. manual:               Volume Label Utility                       10.22.93
  2.                       ====================
  3.                        © 1993 Erin Monaco
  4.  
  5. (Verbose narrative version)
  6.  
  7.      Volume Label Utility is ShareWare. Try it for 30 days, if you find
  8. it useful please register. Regardless please feel free to give copies
  9. to friends, relatives, household pets and optionally your dentist or
  10. favorite police officer. To register please send a check or money order
  11. for $5 (US funds) to:
  12.  
  13.      Erin M. Monaco
  14.      35244 Chestnut
  15.      Wayne, MI 48184
  16.  
  17. You may direct comments or suggestions to the above address. I can also
  18. be reached via GEnie @ E.MONACO
  19.  
  20. ****************************
  21. Update: 12.06.93
  22.  
  23. - VOL_UTIL.RSC no longer neccessary as its been embedded in the program.
  24. - Added sequential extension support.
  25.  
  26. New sequential extension support notes:
  27. =======================================
  28.  
  29.   Looking at the main dialog you will notice a few changes; 1) above
  30. your six standard sequence buttons (1E?) you'll find text which shows
  31. this row of buttons belongs to the filename sequence field. 2) you will
  32. see text below that which points to another set of radio buttons... as
  33. the text indicates these buttons are for using a sequence field in the
  34. extension of the volume label. Since there are only three characters
  35. in an extension you are limited to three buttons 1E1, 1E2, 1E3. These
  36. buttons operate exactly like the original sequence buttons, the only
  37. difference being that they affect and use the extension for the sequence
  38. # field. As before blanks and nulls will be changed to '_' (underscores)
  39. so VLU is able to correctly make the label. When setting a Sequence
  40. button for the extension the # Sig display "(? Sig) is updated to reflect
  41. the number of significant chars before the # field for... the extension
  42. only! Selecting "1E1" (under extension) changes ? Sig to 2 Sig which means
  43. you can use the first two characters in the extension for your own
  44. purpose. As you probably guessed the extensions # field is also right
  45. justified. 
  46.  
  47.  
  48. Note:
  49. =====
  50.  
  51.   If you have installed MultiDialog by Helmut Neukirchen you must turn
  52. it off via the accessory. The Volume Label Utility already displays all
  53. dialogs in a window, using MultiDialog causes two windows to be opened,
  54. which also messes up my work around of the AES's inability to do anything
  55. while using the Form_Do() call. That would be the exiting of a form_do
  56. via the GEM icon.
  57.  
  58. ****************************
  59.  
  60.      Volume Label Utility was written in Lattice C version 5.52. It takes
  61. advantage of GEM and as such will not run from the auto folder or with an
  62. extension of .TOS. Volume Label Utility will however, run as an .APP, .PRG
  63. or Desk Accessory. Regardless of your choice of the above methods the user
  64. interface remains consistant. Please ensure that the resource file is in
  65. the same directory as the program file.
  66.  
  67.      Interaction with Volume Label Utility takes place through a series
  68. of dialog boxes. All dialogs are confined to a single window which the
  69. program opens. As such it should be a little more MultiTos friendly. It
  70. is not known at this time whether the program works on any particular
  71. machine, however having used only standard OS calls chances are good
  72. that it will work on all machines. The code however was compiled for
  73. a stock 68000 processor.
  74.  
  75.      Upon running the program or selecting it via a DA slot you are
  76. presented with the credits dialog. Clicking done brings you to the
  77. main dialog. Immediately you'll say to yourself... "what the hey...?"
  78. as well you should, for this is no ORDINARY volume labeler!!!
  79.  
  80.      Thats right folks, it slices, it dices, it chops, grates and... er
  81. ok... so it actually doesn't do all that, in fact it doesn't do any of
  82. that. (To many 30 min. infomercials I suspect). Truth be told it only
  83. does ONE thing... (right) lets you create volume labels.
  84.  
  85.      Being the disk librarian of an Atari users group, and being a
  86. bugger on small details I was a little upset over not having a nice
  87. simple volume labeler. So being the macho-sist that I am I decided
  88. "what the heck, I'll write one myself!" Somehow I suspect that great
  89. nations have fallen due to similar decisions.
  90.  
  91.      So finally, after many years of toil (ok, it was only a month)
  92. the Volume Label Utility was hatched from the abyss of my mind. Like
  93. any true bureaucracy, we software engineers (read programmers) in
  94. addition to having our own little sub-culture (we're weird ok?) are
  95. tasked to no end (and yes I do like Star Trek!) by the mere idea that
  96. a software engineering project ("program") could be simple. WELL! We
  97. software engineers not wanting to have anything what so ever to do
  98. with that, are compelled to take a simple project and transform it.
  99.  
  100. With this in mind your average engineer will sit down with his/her
  101. Coke classic, favorite CD, programming calculator, the equivalent
  102. of the library of congress worth of programming manuals, peril
  103. sensitive sunglasses with UV coating and his/her drug of choice...
  104. my drug of choice being King Dons fed intravenously throughout the
  105. entire project. Ah and last but not least our magic wands of Bill
  106. Gates... with which all real work is accomplished. Yes in short
  107. order your resourceful software engineer will take an otherwise
  108. simple project and transform it into an utterly obese, never
  109. previously encountered intelligent glob of spaghetti code. Code
  110. with an insatiable appetite for RAM. Code making itself right at
  111. home on your hard drive, a happy slob who delights in corrupting
  112. the morals of your favorite word processor. Now where was I...
  113. ah yes... the documentation!
  114.  
  115.      Lets try to forget all those sophisticated and arcane buttons
  116. on our main dialog for just one moment. In essence VLU reads and
  117. writes volume labels. (well thats pretty simple) If your like me
  118. reading them isn't nearly as fun as writing them so this is where
  119. VLU takes a detour from your average labeler. Lets for a second
  120. assume you have two hundred disks all of which perhaps belong to
  121. a single category or library. Now it makes sense to catalog the
  122. disks and their contents for later reference etc. It would then
  123. also make sense to label these disks according to their library
  124. or category. Say we have a software library with 200 utility disks
  125. all of which we wish to label to improve cataloging. We might
  126. choose a lable such as UTILnnnn.DSK with the nnnn being a number
  127. starting at 0000 and incrementing by one for each successive
  128. disk. (Ugh, thats a lot of typing!) Now you have three choices,
  129. 1) start typing. 2) write a program to automate this task which
  130. merely asks you to insert the next disk. (Do you have your wand
  131. of Bill Gates?) or 3) You can use Volume Label Utility! (or as
  132. a last resort you can explain to your kid that its the latest
  133. in interactive computer game technology and dump it on him/her, 
  134. however due to the severity of child labor laws I do not
  135. recommend this.)
  136.  
  137.      WHAT!? still with me? Ok, given the above example all you'd
  138. have to do is edit the current filename field with your initial
  139. label as UTIL0000.DSK, then select the 1E4 button (because you'd
  140. like a number sequence in the range of 0 - 9999. Insert your
  141. first disk and click the SEQ button (stands for sequence) and
  142. viola your label is written to the disk! But thats not all...
  143. now you'll notice the current label has been modified and it now
  144. reads UTIL0001.DSK!!! Hey, your catchin on, thats right, now all
  145. you have to do is insert the next disk and click on SEQ again!
  146. If you reach 9999 you'll flip back to 0000. Pretty nifty huh?
  147.  
  148.      "Okay" you say, "but what if I only have 50 disks, or maybe I
  149. have half a million!" No problem, by selecting one of the 1E? buttons
  150. you can choose a range from 0-99 (1E2) to 0-999999 (1E6). The numbers
  151. will be right justified within the filename portion of the label,
  152. this is the portion to the left of the "." with the portion to the
  153. right of the period being of course the extension. Above the current
  154. label is another editable field in which you can change the current
  155. drive. To the right of